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1 INTRODUCTION AND OVERVIEW 
(^1 BACKGROUND 

The lacs driver megabus services (Idms) Is a component of the 
lacs driver In the Ian subsystem. The Idms Is the lacs driver’s 
Interface to the lacs via the 16 megabus. The Idms Is used by 
the lacs driver's layer servers (Is) when they wish to send lo or 
lold requests to the lacs. 

1 .2 BASIC PURPOSE 

The Idms has several purposes, they are; to Issue lold's to the 
lacs, to process Interrupts from the lacs, to Issue lo's to the 
lacs, to maintain flow control at the controller level and to 
process nak'd lo's. 

1 .3 BASIC STRUCTURE 


Figure 1 shows the relation of the Idms to the other components 
of the lacs driver. Figure 2 shows the subcomponents of the 
Idms. The following Is a brief description of the functions of 
each subcomponent of the Idls: 



determination routine - This routine determines whether to 
call the Issue lo or Issue lold routine. The determination 
Is made from the Input parameters. The routine Is also 
responsible for returning to the calling routine. 

Issue lold routine - This routine will Issue an lold to the 
lacs. The buffer address and range In the lold represent 
the Ian control block (Icb). The Icb Is supplied as an 
Input parameter when the Is calls the Idms. The routine Is 
also responsible In queuing Icbs on the lit, checking 
controller states, calling the flow control routine, and 
handling naks by the megabus. 


Issue lo routine - This routine will Issue an lo to the 
lacs. The function to be performed Is supplied as an Input 
parameter when the Is calls the Idms. The routine Is also 
responsible for checking controller states and handling naks 
by the megabus. 


Interrupt processing routine - This routine Is responsible 
for handling Interrupts from the lacs. The Interrupts will 
be a result of the lacs completing a Icb. The routine will 
dequeue completed Icbs off the lit queue, call the flow 
control routine, and depending on how the Icb Is set up the 
routine will Inj to the Is which Issued the Icb to the Idms, 
or perform a task request, or release the Icb's memory. 



flow control routine - This routine Is responsible for 
maintaining the count of Icbs outstanding at a controller. 
The routine will queue Icbs If the controller limits are 
exceeded, and dequeue and Issue Icb via a call to the Issue 
lold routine when the limits recede. 
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nak'd routine - This routine is responsible for processing a 
lo or lold which was nak'd an excessive amount of times 
during processing of the issue lo or issue lold routines. 

1 .4 BASIC OPERATION 

1.4.1 DETERMINATION ROUTINE 

The determination routine will be invoked via a Inj from a 
rout Ine wIshing to issue a io or lold to the controller. The 
routine will save the return address. The routine will then 
validate the input parameters, returning to the calling routine 
If any of the parameters are Invalid. Then using the Input 
parameters the routine determines whether to call the Issue lold 
or issue io routine. The call to the Issue routine is a JnJ, the 
issue routines are expected to return to the determination 
routine. Upon return from a issue routine the determination 
routine will retrieve the saved return address (of the Is), then 
wiI I return to the cal ler with a status which was set up by the 
issue routine. 

1.4.1.1 DETERMINATION ROUTINE ERRORS 

Errors reported by the Idms determination routine are; 

1. Invalid input parameters when the routine Is 
cal led. 

1.4.2 ISSUE lOLD ROUTINE 

This routine is Invoked via a Inj from the determination 
routine. The routine saves the return address. The routine will 
call the flow control (fc) routine, if the fc routine return with 
an error status, the issue lold routine will return to the 
determination routine with the error message from the fc 
routine. The routine will next check the controller state, if 
the controller is In the Otherwise, the routine will set up the 
registers for the lold, using Information in the Icb, the nak'd 
retry count is reset, and the lold Is Issued. If the lold Is 
nak'd the routine will set the controller into a nak'd state, 
increment the retry count, then try the lold again. If the iold 
is nak'd repeatedly, the nak'd routine will be called. If a 
nak'd lold is successful the controller is placed out of the 
nak'd state and a successful return to the determination routine 
Is performed. If the lold Is successful a return to the 
determination routine is performed. 

1.4.2.1 ISSUE IOLD ROUTINE ERRORS 

Errors reported by the issue Iold routine are: 

1. The flow control routine return with an error. 

2. lold is nak'd. 
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1 .4.3 ISSUE 10 ROUTINE 



The Issue lo routine Is Invoked via a InJ from the 
determination routine. The routine saves the return address. 

The routine will Issue the lo using the supplied Input 
parameters. If the lo Is nak'd, the routine will retry the lo a 
set number of times until the lo Is successful or the limit of 
retrying the lo Is reached. If the retry limit was exceeded the 
routine will call the nak'd routine. Otherwise, a successful 
return to the caller (determination routine) Is done. 


Note, If a Input Id lo Is sent to a controller which Is In a 
active state (I.e. ready to recleve lold's) the controller will 
hang, therefore the state of the controller must be checked 
before sending an Input Id. 

1.4.3.1 ISSUE 10 ROUTINE ERRORS 

Errors reported by the Issue lo routine are: 

1 . Io Is nak'd. 

1.4.4 INTERRUPT PROCESSING ROUTINE 



The Interrupt processing routine Is Invoked via a Interrupt 
from the lacs. The lacs Interrupts when It has completed a Icb. 
The routine will retrieve the Interrupt control word (word 0 of 
the Interrupt level tcb). From the lew bits the routine will 
obtain the pointer to the lit In which the completed Icb Is 
queued. The queue of Icb's Is searched until a completed Icb Is 
found. When found the Icb Is dequeued from the active Icb 
queue. The pointer to the next Icb In the queue Is saved, and 
the flow control routine Is called. Upon return from the fc 
routine, the Interrupt processing routine will perform the 
function specified In the 16 portion of the Icb. The options 
are: performing a task request, performing a Inj to a layer 
server routine, or nothing. After the routine performs the 
specified request, the pointer to the next Icb In the queue Is 
retrieved, then the list Is searched until another completed Icb 
Is found or the end of the queue Is reached. If another 
completed Icb Is found, the routine will repeat the above steps 
until the end of queue Is reached. If the end of the queue Is 
reached, the level will be exited via a lev Instruction. 


1 .4.4.1 INTERRUPT PROCESSING ROUTINE ERRORS 


Errors reported by the Interrupt processing routine are: 
1 . I cw = 0. 


1.4.5 FLOW CONTROL ROUTINE 

There are 2 flow control routines called the pre Icb flow control 
f-\ routine and post Icb flow control routine. 
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1.4.5.1 PRE LCB FLOW CONTROL ROUTINE 

The pre Icb fc routine Is Invoked via a call from the Issue 
lold routine. The routine will test If a Icb can be sent to this 
controller, this check is done through counts kept In a Ian data 
sturcture. If the controller has sufficent resources the pre Icb 
fc routine will Increment the lold count, then return to the 
Issue lold routine with an successful status. If an lold can not 
be sent to the controller, the routine will queue the Icb on a 
wait queue and return to the Issue lold routine with an error 
status. 


1.4.5.1.1 PRE LCB FLOW CONTROL ROUTINE ERRORS 

Errors reported by the pre Icb flow control routine are: 

1. Lcb queued because of flow control. 

1.4.5.2 POST LCB FLOW CONTROL ROUTINE 

The post Icb fc routine Is Invoked via a call from the 
interrupt processing routine after a completed Icb has been 
found. The routine wllI decrement the lold count for the 
controller, then If there are any Icb waiting to the sent the 
routine will dequeue the head lcb off the wait queue, call the 
Idms determintlon routine, then return to the Interrupt 
processing routine. Otherwise, If there are no lcb waiting the 
routine will return to the Interrupt processing routine with 
after decremting the controller lold count. 

1.4.5.2.1 POST LCB FLOW CONTROL ROUTINE ERRORS 

Errors which are reported by the post fc routine are; 

1. The Idms returns with an error. 

1.4.6 NAK'D ROUTINE 

The nak’d routine Is Invoked via a call from the Issue lo or 
Issue lold routines when an lold has been nak’d. If the lold was 
Issued (I.e. the lold went through on subsquent tries) the 
routine will Issue all lold queued on the nak'd queue off the 
controller directory, then return to the calling routine. If th 
elold was not Issued, the routine will call the sm Is. Upon 
return from the sm Is the routine will return to the calling 
routine. 

1.4.6.1 NAK»D ROUTINE ERRORS 

Errors which may occur In processing nak'd lo orders are; 

1. Sm Is returns with an error. 

2 EXTERNAL SPECIFICATIONS 

2.1 OWNED DATA STRUCTURES 
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The following pages define the data structures owned and used by 
the Ian subsystem: 


2.2 EXTERNAL INTERFACES 


2.2.1 M0D400 EXECUTIVE SOFTWARE ROUTINES 


2.2.1.1 ZXREQ - Request task 

entry: Inj $b5,zxreq 

Input: $b4 = address of task request block 

$b5 * return address 

output; $r1 - 0 - task request was queued successfully 
$rl > 0 - task request was not queued 
$b4 * address of task request block 

modifies: $rl,$r2,$r3,$b1,$b2,$b3 

function: Request a normal task with a supplied request block 

polnter. 

2.2.1.2 ZHCOMM - Null address 


function: Will load the null address when referenced l.e. Idb 

^ $b5,<zhcomm will load $b5 with the null address. 

2.2.1.3 ZXD_PR - Dequeue and post IRB 

entry: Inj $b5,zxd_pr 

Input: $r2 = completion status for request 

$b5 = return address 


output; $r1 = 0 - request was dequeued and posted 
$r1 > 0 - no request on queue exist 


2.2.2 MOD400 DATA STRUCTURES IMPLEMENTED 


The following system owned data structures are referenced by 
the Idms: 

Task Control Block (TCB) 

System Control Block (SCB) 


2.2.3 USER INTERFACES 

2 .2.3.1 LDMS INTERFACE (MSIIOR) 
call: 1nJ $b5,msI I or 

€ 
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Input: $b'1 = a( Icb) 

$rl * function code 
0009 - output Icb 
OOOx - reset/halt 
OOOx “ load/dump 
0001 - strar lo 
0026 - Input Id 

$bl = a(lcb) If function code = 9 
$b1 = a(llt) If function code <> 9 
$b5 = a(return) 

output: $rl = status 

0000 - lo or lold was successful 
0001 - lo or lold was nak'd 

0002 - lold not performed, Icb queued because of 
flow control 

ffff - Inviald function code 
$r2 = hardward Id If function code = Input Id on Input 
$b1 = a( 1 It) or a(Icb) 

mod IfIes: $r2, $r1 

2.2.3.2 LCB FORMAT 

cb_prl 

Input: mbz 

output: na 

cb_ncb 

Input: mbz 

output: na 

cb_rct 

Input: address of caller's ret 

output: same as Input 

cb_lIt 

Input: address of the lit In which this Icb will be 

queued 

output: same as Input 

cb_f rw 

Input: bit 0-3 - 9 

bit 4-7 - mbz (lorb major function code ?) 

bit 8-f - XX 

same as Input 
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cb_Itp 

Input: 
output: 
cb_I nd 

Input: 


outp ut: 
cb_Icw 

Input: 

output: 
cb fsf 


address of the post processing routine, or trb, 

on null 

same as Input 


IndIcators 

bit 7 - cb_Itp points to a trb when set 
bit 6 - sm Icb when set 
a I I other bIts mbz 
same as Input 


bit 0-5 - mbz 

bit 6-9 - cpu number to Interrupt 
bit a-f - level to Interrupt the cpu 
same as Input 


I nput: 



output: 
cb cts 


function specific function code 
function codes for read Icbs are: 
0012 - cl read 
0022 - CO read 
0042 - CO expideted read 
function codes for write Icbs are: 
0011 - cl write 
0021 - CO write 
0042 - CO expideted write 
function codes for event Icbs are: 
OOle - sap event 
002 e - connection event 
004e - sm event 
same as Input 


Input: mbz 

output: bit 0-7 - rfu and mbz 

bit 8 - Invalid function code when set 

bit 9 - ram memory exausted when set 

bit a - ram location non-existent when set 

bit b - ram parity error when set 

bit c - level 6 memory yellow when set 

bit d - level 6 memory non-existent when set 

bit e - level 6 bus parity error when set 

bit f - level 6 memeory red when set 


( 
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cb_fss 

Input: mbz 

output: function specific status 

0001 ” sap not active 
0002 - lack of resources 
0004 - controller unavailable 
0008 - sm layer Instance error 
0020 - sap already active 
0040 - sap already deactivated 
0080 - recleve buffer too small 
0100 - Illegal logical address 
0200 - Invalid Icb 
0400 - write credit violations 
0800 - read credit violations 

cb_cbs 

Input: mbz 

output: bit 0 - Icb is complete when set 

bit 1 - Icb not processed when set 
bit 2-f - rfu and mbz 

cb_abs 

Input: mbz 

output: actual buffer size if cb_fss = 0080, otherwise 

same as Input 

cb_lsa 

input: logical local address for cl operations 

output: same as Input 

cb_lra 

Input: logical remote address for cl write operation, mbz 

for event and read operations 
output: logical remote address for cl read operations, 

otherwise same as Input 

cb_trg 

input: total byte range 

output: same as Input 

cb_bct 

Input: number of buffers 

output: same as Input 
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cb_ad1 

Input: 
outp ut: 


cb_rg1 

Input: 
outp ut: 

cb_rs1 

Input: 
output: 

cb ad2 


Input: 
outp ut: 

cb_rg2 

Input: 
output: 

cb rs2 



Input: 
output: 

cb ad3 


Input: 
outp ut: 

cb_rg3 

Input: 
outp ut: 

cb rs3 


Input: 
output: 

cb ad4 


Input: 
outp ut: 


cb_rg4 


Input: 
outp ut: 


buffer #1 address 
same as Input 


buffer #1 range 
same as Input 


mbz 

buffer #1 residual range 


buffer #2 address 
same as Input 


buffer #2 range 
same as Input 


mbz 

buffer #2 residual range 


buffer #3 address 
same as Input 


buffer #3 range 
same as Input 


mbz 

buffer #3 residual range 


buffer §A address 
same as Input 


buffer #4 range 
same as Input 
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cb_rs4 

1 nput: 
output: 

cb_acl5 

Input: 
output: 

cb_rg5 

Input: 
output: 

cb_rs5 

Input: 
output: 

cb_ad6 

Input: 

output: 

cb_rg6 

Input: 

output: 

cb_rs6 

input: 
output: 

cb_ad7 

Input: 

output: 

cb_rg7 

Input: 
outp ut: 

cb_rs7 

Input: 

output: 

cb_ad8 

Input: 
outp ut: 


mbz 

buffer #4 residual range 


buffer #5 address 
same as input 


buffer #5 range 
same as Input 


mbz 

buffer #5 residual range 


buffer #6 address 
same as Input 


buffer #6 range 
same as Input 


mbz 

buffer #6 residual range 


buffer #7 address 
same as Input 


buffer #7 range 
same as Input 


mbz 

buffer #7 residual range 


buffer #8 address 
same as Input 
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cb_rg8 

Input; buffer #8 range 

output: same as Input 

cb_rs8 

Input: mbz 

output: buffer #8 residual range 


The rest of the Icb fields are function specific fields, there 
defintlon can be found In the Idls, Me Is or the cl4 Is or the 
sm Is. 

2.3 INITIALIZATION REQUIREMENTS 

The dm process will load the I dms Into system memory, and 
configure at least one Interrupt level for the Idms to execute 
under. The Idms bound unit will be loaded Into memory by dm via 
a task request. At this time the Idms will begin executing It’s 
Initialization code. The Idms 1st code consists fo performing 
the following: 

1. Posting the task request, using a call to the zxd_pr 
routine. , 



2. Since the levels the Idms Interrupt processing code 

executes under will only be Invoked as a result of an 
Interrupt, the fixed to level bit (mt_flx) In the 
teb’s first Indicators word (t Ind) must be set. 


3. Exit the level via a lev enable Instruction, leaving 
the p-counter at the entry point of the Interrupt 
processing routine. 

2.4 TERMINATION REQUIREMENTS 

There are no termination requirements since the Idms will be 
active as long as the mod400 operating system Is active. 

2.5 ENVIRONMENT 

The following I terns are required by the Idms for It to 
perform It's task; 

1. Mod400 operating system. 

2. Any 16 computer model except 6/10 and 6/20. 

3 . Lan dm. 



4. A lacs attached to the 16 megabus. 

5. A user of the lan subsystem to drive the lacs driver. 
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2.6 TIMING AND SIZE REQUIREMENTS 

Currently memory usage and timing requirements are not an 
Issue. However, the code should be be as efficient as possible 
(note: the Interrupt processing routine executes at a low level, 
and care should be taken in writing the code to make it very 
ef f1cIent) . 

2.7 ASSEMBLY AND LINKING 

The software will be written in Series 6 Assembly Language 
using a subset of the instruction set that Is present on all 
Series 6 systems. The Idms will be linked with the lacs driver 
Interface services module by the gcos6 mod400 linker to produce a 
portion of the lacs driver's bound units. The name of the module 
will be zqllms. 

2.8 TESTING CONSIDERATIONS 

Since the product is new, all functions wlM be tested by 
the developer, and software test. 

2.9 DOCUMENTATION CONSIDERATIONS 

The Idms source listing will include a program design 
language used by the developer to aid In the maintenance by 
future developers and also to aid in the development by the 
developer. 

2.10 ERROR MESSAGES 

The I dms will In-form the calling layer server of an error by 
placing into $r1 the error message, then returning to the calling 
routine. 

1 . $r1 = 0001 - lo or iold was repeatedly nak'd. 

2 . $r1 = 0002 - Icb queued because of flow control. 

3. $r1 ® 0000 - lo or lold was successful. 

4. $r1 = ffff - invalid function code. 

2.10.1 INTERRUPT PROCESSING ERRORS 

1 . Icw = 0 

3 INTERNAL SPECIFICATION 

3.1 OVERVIEW 

There are 2 ways to activate the Idms code, they are: 

1. A layer server requests an lo or lold be sent to the 
lacs. 
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^ 2. An Interrupt Is generated by the lacs. 

372 SUBCOMPONENT DESCRIPTION 
3.2.1 DETERMINATION ROUTINE 

The routine Is Invoked via a call from a Is wishing to Issue an 
Icb. The routine requires the following Input parameters: 

$r1 = function code 

0009 - output Icb 
0001 - start I/o 
OOOx - load/dump 
OOOx - reset/halt 
0026 - Input Id 

$b1 * a(lcb) If function code = 9 
$b1 = a(llt) If function code <> 9 
$b5 = return address 

The routine supplies the following output parameters: 



$r1 = status 

0000 - lo or lold was successful 
0001 - lo or lold was nak*d 

0002 - lold not performed, icb queued because of fc 
ffff - Invalid function code 

$r2 * hardware id If function code = Input Id upon Input 
$b1 = a(Icb) 

When the determination routine Is Invoked by a Is the routine 
performs the following: 

1. Validates the function code, returning to the caller 
If the function code Is no in the allowable range. 

2. Saves the return address. 


3. Depending on the function code, the routine calls 

either the Issue lold routine or Issue lo routines. 


When the determination routine Is Invoked by either the issue 
lold routine or Issue lo routine, the routine performs the 
foI lowing: 


1. Retrieve the return address. 

2. Jumps back to the Is. 


3.2.2 ISSUE lOLD ROUTINE 



The Issue lold routine is called by the determination routine. 
The routine requires the following input parameters: 
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$r1 = function 

0009 - output Icb 
0001 - start lo 
OOOx - load/dump 
$b1 = a(Icb) 

$b5 * return address 

The routine supplies the foI IowIng output parameters: 

$rl = status 

0000 - lold was successful 

0002 - lold not Issued, Icb was queued because of fc. 
0001 - lold not Issued because of success nak'd 
$b1 = a(Icb) 

The routine performs the following function: 

1 . Save the return address 

2. Retrieve the pointer to the lit from the Icb (cb_nt) 

3. Mask In the control Information from the lit (II_Id2) 
with the function code. 

4. Set up the Icb length word, along with the protocol 
Id. 

5. Set the pointer to the lacs specific portion of the 
Icb. 

6 . Call flow control routine. 

7. If a non zero status resulted In the call, retrieve 
the return address and jump back to the determination 
routine. 

8 . Clear the current lold retry count. 

9. Increment the current lold count. If the current count 
> the maximum count call the nak’d routine. Upon 
return from the nak’d routine return to the caller. 

10 . Issue the Io|d. 

11. If the lold was nak’d, go to #8. 

12. Queue the Icb on the tall of the lit active Icb queue. 

13. Return to the caller with a successful return status. 
*********** states must be checked before an lold can be Issued 
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3.2.3 ISSUE 10 ROUTINE 



The issue io routine Is invoked through a call by the 
determination routine. The routine requires the following input 
parameters; 


$r1 = function code 

0026 - input id 
0001 - start i/o 
OOOx - reset/halt 
$r2 = protocol id 
$b1 = a(I it) 

$b5 = return address 



The routine supplies the following output parameters: 

$r1 = status 

0000 - lo was successful 

0001 - lo not issued because it was nak'd 
$r2 = hardware id if $r1 = 26 on input 

The routine performs the following function: 

1 . Save the return address 

2. Mask the function code with the Ii_id2 word in the 
lit, to form the control word. 

3., Clear the current lo retry count in the lit,. 

4. Increment the current io count, if the current count 
is greater than the maximum count, call the nak'd 
routine. Upon return from the nak’d routine return to 
the cal ler. 

5. Issue the io. 

6 . If the io was nak'd go to #4. 

7. Return to the caller with a successful return status. 


*********** States must be checked before the io is Issued 
3.2.4 INTERRUPT PROCESSING ROUTINE 


The interrupt processing routine Is invoked via an Interrupt 
generated when the lacs completes an Icb. The routine requires 
the following input parameters: 

$iv.O * Interrupt control word (tcb word 0) 

The routine supplies the.foI Iowing output parameters: 



terminates it's level when complete 
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When the interrupt processing routine Is Invoked as a result of 
an Interrupt, It performs the following. 

1. Retrieve the lew from SIv.o. 

2. If the lew = 0, then go to an error processing routine 
(tbd). 

3. Retrieve the pointer to the seb, retrieve the pointer 
to the cd from the scb. 

4. Index Into the cd by the lew bits 0-3 for the pointer 
to the ct. 

5. Index Into the ct by the lew bits 4-6 for the pointer 
to the It. 

6 . Index Into the It by the lew bits 7-9 for the pointer 
to the lit. 

7. Retrieve the pointer to the active Icb queue from the 
I It. 

8 . Search the queue starting from the head, until a 
completed Icb Is found. If no completed Icb Is found, 
terminate the level through a lev Instruction, make 
sure the p-counter Is set to the start of this 

rout Ine. 

9. Dequeue the completed Icb, save the pointer to the 
next Icb on the queue, call the flow control routine. 

10. Retrieve the cb_Itp word. 

11. If bit 7 of the cb_lnd word Is set, call the exec 
request task routine to request the task from the trb 
in the cb_Itp word, with $b5 = return, $b4 * a(trb), 
and all registers saved. Restore the registers, (If 
an error resulted In the call what the routine will do 
Is tbd), retrieve the pointer to the next Icb In the 
queue and go to . 

12. If bit 7 of the cb_itp word Is not set, Inj to the 
address specified In the cb_Itp word, with $b5 * 
return address and $bl = Icb, all other registers are 
saved.. Upon return restore the registers, retrieve 
the pointer to the next Icb and go to #8. 

13. If bit 6 of the cb_Itp word Is set, release the memory 
of the Icb through an exec call (tcb). Retrieve the 
pointer to the next Icb In the queue and go to #8. 
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3.2.5 FLOW CONTROL ROUTINES 

C..5.1 PRE LCB FLOW CONTROL ROUTINE 

The pre Icb fc routine Is Invoked by the Issue lold routine. 
The routine requires the following Input parameters: 

$b1 = a(Icb) 

$b2 = a(rct) 

$b3 « a(tt) 

$b5 = return address 

The routine requires the following output parmaeters: 

$b1 = a(Icb) 

$b2 = a(rct) 

$b3 = a{tt) 

$r1 = status 

0000 - ok to send Icb 

0001 - Icb queued because of flow control 

The routine performs the following function: 

1 . 

3.2.6 NAK'D ROUTINE 
tbd 

C PDL 

5 ISSUES 

1. Controller states 

2. Nak’d Icb’s 

3. p 


( 
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